History of API Additions and Changes in ATSUI

Table B-1 alphabetically lists the functions whose implementation have changed with ATSUI 1.2.

Table B-1  Functions whose implementation has changed in ATSUI 1.2

Function name

Description of change in ATSUI 1.2

ATSUGetGlyphBounds Now the maximum number of enclosing trapezoids returned is 127 rather than 31, as was true for the implementation of this function with ATSUI 1.0 and 1.1.
ATSUGetTextHighlight The maximum number of components that can be passed back is 127 rather than 31.
ATSUSetFontFeatures If you try to set mutually exclusive font features, whether in one or multiple calls, ATSUI 1.2 removes the existing feature and replaces it with your newly set feature. Earlier versions of ATSUI will not remove a feature when you set its contradictory feature.

The following constants were introduced with ATSUI 1.2: gestaltATSUUpdate2, gestaltATSUTextLocatorUsageFeature, kATSLineTabAdjustEnabled, kATSUStyleTextLocatorTag, kATSULineLanguageTag, kATSULineTextLocatorTag, and kATSUMaxLineTag.

Table B-2 alphabetically lists the functions that were introduced with ATSUI 1.1.

Table B-2  Functions new to ATSUI 1.1

Function name

ATSUClearLayoutCache
ATSUClearLineControls
ATSUCopyLineControls
ATSUCountFontTracking
ATSUCreateAndCopyTextLayout
ATSUCreateMemorySetting
ATSUDisposeMemorySetting
ATSUGetAllLineControls
ATSUGetCurrentMemorySetting
ATSUGetFontFallbacks
ATSUGetIndFontTracking
ATSUGetLineControl
ATSUSetCurrentMemorySetting
ATSUSetFontFallbacks
ATSUSetLineControls
ATSUCustomAllocFunc
ATSUCustomGrowFunc
ATSUCustomFreeFunc

Table B-3 alphabetically lists the ATSUI 1.0 functions whose implementation changed with ATSUI 1.1.

Table B-3  Functions whose implementation has changed with ATSUI 1.1

Function name

Description of change in 1.0

ATSUBreakLine Now returns the result code kATSULineBreakInWord to indicate that ATSUBreakLine performed a line break within a word. Note that this is a status message, not an error code.
ATSUCopyToHandle No longer used. Instead, use the 'ustl' resource to format styled text in the clipboard.
ATSUHighlightText Now can extend highlighting across tab stops using the mask constants kATSLineFillOutToWidth and kATSLineImposeNoAngleForEnds.
ATSUPasteFromHandle No longer used. Instead, use the 'ustl' resource to format styled text in the clipboard.
ATSUSetAttributes New style run attribute tag constants now available.
ATSUSetLayoutControls New text layout and line attribute tag constants now available.
ATSUUnhighlightText Now can erase highlighting across tab stops using the mask constants kATSLineFillOutToWidth and kATSLineImposeNoAngleForEnds.


© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)